Skip to content

MTA-6288 Centralized configuration in Visual Studio Code plugin#313

Open
Pkylas007 wants to merge 5 commits intomainfrom
mta-6288-centralized-config-vscode-ide-plugin
Open

MTA-6288 Centralized configuration in Visual Studio Code plugin#313
Pkylas007 wants to merge 5 commits intomainfrom
mta-6288-centralized-config-vscode-ide-plugin

Conversation

@Pkylas007
Copy link
Collaborator

@Pkylas007 Pkylas007 commented Feb 19, 2026

JIRA

Version

  • 8.1.0

Preview

Summary by CodeRabbit

  • Documentation
    • Added a guide for analyzing applications in Visual Studio Code using centrally managed Hub analysis profiles, covering overview, Technology Preview note, prerequisites, and related resources.
    • Documented Hub integration and configuration steps: Hub URL, SSL verification, authentication, credentials, Solution Server, Profile Sync, selecting a profile, and running analysis.
    • Included the new topic into the main VS Code extension guide.
    • Fixed a minor typo in IDE settings instructions.

Prabha Kylasamiyer Sundara Rajan added 2 commits February 19, 2026 16:36
Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@coderabbitai
Copy link

coderabbitai bot commented Feb 19, 2026

📝 Walkthrough

Walkthrough

Adds a new VS Code procedure documenting how to run static analysis using Hub-managed analysis profiles, and updates the VS Code extension guide to include the new topic; also fixes a small typo in an existing VS Code settings doc.

Changes

Cohort / File(s) Summary
VSCode Analysis Profiles Documentation
docs/topics/vscode/proc_vscode-analyzing-application-using-profiles.adoc
New procedural doc describing centralized Hub-managed analysis profiles: overview, Technology Preview note, prerequisites, Hub configuration (URL, SSL verification, auth, credentials), enabling Solution Server/Profile Sync, selecting a profile, and running analysis.
Documentation Assembly
docs/vs-code-extension-guide/master.adoc
Added an include for the new profiles topic (proc_vscode-analyzing-application-using-profiles.adoc) into the VS Code extension guide.
Typo Fix
docs/topics/vscode/proc_configuring-lighstspeed-ide-settings.adoc
Corrected a typographical error: "clicing" → "clicking" in the Extensions > MTA instruction.

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

🐰
I hopped through text and tiptoed through code,
Brought profiles from the Hub down the VS Code road,
Settings aligned, the analysis thrives,
A rabbit’s small cheer for clearer guides,
Carrot crumbs left where documentation grows.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main change: adding documentation for centralized configuration (analysis profiles) in Visual Studio Code plugin.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch mta-6288-centralized-config-vscode-ide-plugin
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (4)
docs/topics/vscode/proc_vscode-analyzing-application-using-profiles.adoc (4)

35-35: Strengthen security guidance for SSL certificate verification.

The option to skip SSL certificate verification is a significant security concern. Consider adding a more explicit warning that this option should only be used in development/testing environments and never in production.

🛡️ Suggested security guidance enhancement
-.. Enable *Skip SSL certificate verification* if you want to connect to your Hub without verifying the local SSL certificate in the host. 
+.. Enable *Skip SSL certificate verification* if you want to connect to your Hub without verifying the local SSL certificate in the host.
++
+WARNING: Skipping SSL certificate verification should only be used in development or testing environments. Do not use this option in production as it exposes your connection to security risks.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/vscode/proc_vscode-analyzing-application-using-profiles.adoc` at
line 35, Update the sentence that mentions "Skip SSL certificate verification"
to include a clear, explicit security warning: state that skipping SSL
verification should only be used in development or testing environments, never
in production, and briefly note the risk (exposes you to man-in-the-middle
attacks and insecure connections); locate and edit the line containing the
phrase "Skip SSL certificate verification" in the docs topic
(proc_vscode-analyzing-application-using-profiles.adoc) and replace or append
text to make the environment restriction and risk explicit.

8-8: Consider using more formal terminology.

The phrase "hard disk" could be replaced with "local disk" or "local file system" for more formal technical documentation.

📝 Suggested terminology update
-When you connect to the Hub from your Visual Studio Code instance, {ProductShortName} downloads the analysis profiles and custom rules present in the Hub to the `.konveyor/profiles` location in your hard disk. You can use the analysis profile that contains custom rules to perform analyses in your Visual Studio Code IDE environment. If you connect to the Hub, the profile configuration options in your IDE instance are disabled.
+When you connect to the Hub from your Visual Studio Code instance, {ProductShortName} downloads the analysis profiles and custom rules present in the Hub to the `.konveyor/profiles` location on your local file system. You can use the analysis profile that contains custom rules to perform analyses in your Visual Studio Code IDE environment. If you connect to the Hub, the profile configuration options in your IDE instance are disabled.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/vscode/proc_vscode-analyzing-application-using-profiles.adoc` at
line 8, Replace the informal phrase "hard disk" in the sentence that mentions
the ".konveyor/profiles" location with a more formal term such as "local disk"
or "local file system"; specifically update the sentence "downloads the analysis
profiles and custom rules present in the Hub to the `.konveyor/profiles`
location in your hard disk." to use "local disk" or "local file system" so the
documentation uses consistent formal terminology.

21-24: Consider adding a reference to supported languages documentation.

Line 23 mentions "supported languages" but doesn't specify which languages or link to where this is documented. If this information is available elsewhere in the documentation, consider adding a cross-reference for user convenience.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/vscode/proc_vscode-analyzing-application-using-profiles.adoc`
around lines 21 - 24, Update the "Prerequisites" section so the phrase
"supported languages" links to or lists the documentation that enumerates
supported languages; modify the line that currently reads "* You opened a
project written in one of the supported languages in your VS Code workspace." to
include a cross-reference or short parenthetical (e.g., "see Supported
Languages") pointing to the canonical doc or page that lists supported languages
so readers can quickly find which languages are supported.

39-39: Improve sentence clarity by breaking into multiple sentences.

This sentence is quite long and covers multiple concepts (enabling, periodic downloads, and consequences of not syncing). Consider breaking it into shorter, clearer sentences for better readability.

📝 Suggested clarity improvement
-.. Enable *Profile Sync* to sync the profiles with the Hub. {ProductShortName} periodically downloads the latest version of the profiles from the Hub. {ProductShortName} does not update the profiles and rules if you do not sync the profiles with the Hub.
+.. Enable *Profile Sync* to sync the profiles with the Hub. When enabled, {ProductShortName} periodically downloads the latest version of the profiles from the Hub. If you do not enable profile sync, {ProductShortName} does not update the profiles and rules.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/vscode/proc_vscode-analyzing-application-using-profiles.adoc` at
line 39, The long sentence starting with "Enable *Profile Sync*" should be split
into multiple sentences for clarity: first state that users should enable
Profile Sync to sync profiles with the Hub (reference the phrase "Enable
*Profile Sync*"), then add a second sentence saying that {ProductShortName}
periodically downloads the latest profiles from the Hub, and a third sentence
clarifying that {ProductShortName} will not update profiles and rules unless
Profile Sync is enabled; keep wording concise and preserve the terms "profiles",
"rules", and "{ProductShortName}" for consistency.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/topics/vscode/proc_vscode-analyzing-application-using-profiles.adoc`:
- Line 35: Update the sentence that mentions "Skip SSL certificate verification"
to include a clear, explicit security warning: state that skipping SSL
verification should only be used in development or testing environments, never
in production, and briefly note the risk (exposes you to man-in-the-middle
attacks and insecure connections); locate and edit the line containing the
phrase "Skip SSL certificate verification" in the docs topic
(proc_vscode-analyzing-application-using-profiles.adoc) and replace or append
text to make the environment restriction and risk explicit.
- Line 8: Replace the informal phrase "hard disk" in the sentence that mentions
the ".konveyor/profiles" location with a more formal term such as "local disk"
or "local file system"; specifically update the sentence "downloads the analysis
profiles and custom rules present in the Hub to the `.konveyor/profiles`
location in your hard disk." to use "local disk" or "local file system" so the
documentation uses consistent formal terminology.
- Around line 21-24: Update the "Prerequisites" section so the phrase "supported
languages" links to or lists the documentation that enumerates supported
languages; modify the line that currently reads "* You opened a project written
in one of the supported languages in your VS Code workspace." to include a
cross-reference or short parenthetical (e.g., "see Supported Languages")
pointing to the canonical doc or page that lists supported languages so readers
can quickly find which languages are supported.
- Line 39: The long sentence starting with "Enable *Profile Sync*" should be
split into multiple sentences for clarity: first state that users should enable
Profile Sync to sync profiles with the Hub (reference the phrase "Enable
*Profile Sync*"), then add a second sentence saying that {ProductShortName}
periodically downloads the latest profiles from the Hub, and a third sentence
clarifying that {ProductShortName} will not update profiles and rules unless
Profile Sync is enabled; keep wording concise and preserve the terms "profiles",
"rules", and "{ProductShortName}" for consistency.

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@Pkylas007 Pkylas007 removed the request for review from dymurray March 11, 2026 03:18
@Pkylas007
Copy link
Collaborator Author

Pkylas007 commented Mar 11, 2026

@fabianvf @abrugaro Could you review this PR, please?


.Prerequisites

* You opened a project written in one of the supported languages in your Visual Studio Code workspace. {ProductShortName} can analyze source code written in `Java`, `C#`, `.NET`, `Node.js`, and `Python`.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For the VScode extensions the languajes are java, javascript, .net, go and c#.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've modified the languages. Could you check, please?

Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
@Pkylas007 Pkylas007 requested a review from abrugaro March 12, 2026 09:50
Signed-off-by: Prabha Kylasamiyer Sundara Rajan <pkylasam@pkylasam-thinkpadp16vgen1.bengluru.csb>
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/topics/vscode/proc_configuring-lighstspeed-ide-settings.adoc (1)

5-5: ⚠️ Potential issue | 🟡 Minor

Fix typo in anchor ID and corresponding cross-reference.

The anchor ID contains "lighstspeed" (a typo for "lightspeed"). An xref in docs/topics/vscode/proc_configuring-profile-settings.adoc:15 references this anchor. Update both the anchor ID and the xref together:

  • docs/topics/vscode/proc_configuring-lighstspeed-ide-settings.adoc:5: Change to configuring-lightspeed-ide-settings_{context}
  • docs/topics/vscode/proc_configuring-profile-settings.adoc:15: Change xref:configuring-lighstspeed-ide-settings_vsc-extension-guide to xref:configuring-lightspeed-ide-settings_vsc-extension-guide
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/topics/vscode/proc_configuring-lighstspeed-ide-settings.adoc` at line 5,
Update the misspelled anchor ID "configuring-lighstspeed-ide-settings_{context}"
to "configuring-lightspeed-ide-settings_{context}" and update the
cross-reference token
"xref:configuring-lighstspeed-ide-settings_vsc-extension-guide" to
"xref:configuring-lightspeed-ide-settings_vsc-extension-guide" so the anchor and
xref match.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@docs/topics/vscode/proc_configuring-lighstspeed-ide-settings.adoc`:
- Line 5: Update the misspelled anchor ID
"configuring-lighstspeed-ide-settings_{context}" to
"configuring-lightspeed-ide-settings_{context}" and update the cross-reference
token "xref:configuring-lighstspeed-ide-settings_vsc-extension-guide" to
"xref:configuring-lightspeed-ide-settings_vsc-extension-guide" so the anchor and
xref match.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 23338442-3b51-4297-985c-40b348b09635

📥 Commits

Reviewing files that changed from the base of the PR and between 8b005a8 and eb10090.

📒 Files selected for processing (1)
  • docs/topics/vscode/proc_configuring-lighstspeed-ide-settings.adoc

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants